home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / jcd124.zip / JCD12.DOC < prev   
Text File  |  1989-06-06  |  16KB  |  445 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                Introduction -JCD V1.21
  8.  
  9.  
  10.                Imagine yourself entrenched in a computer project,  a couple
  11.           of levels deep  in  a  subdirectory  tree. You decide you want to
  12.           move to the bottom of another directory tree so you type:
  13.  
  14.               C:\TC\CODE> cd \com\dnld\game\arcade\larn
  15.  
  16.           and you get the message "Invalid directory". Now frustration sets
  17.           in because not only are you still in the directory '\tc\code' but
  18.           you also have  no  idea  where  you made a mistake. This normally
  19.           prompts one of the best-known computer-related comments.
  20.  
  21.               "The $&#%^* computer should have known what I meant."
  22.  
  23.                Unfortunately, computers quite often do what  you  tell them
  24.           to do instead of what  you  want  them  to  do. But you do have a
  25.           point. The computer should have been able to pick up a  few clues
  26.           from  what  you  typed to accomplish  part  of  the  task  before
  27.           throwing your mistake back in your face. JCD was written  to take
  28.           care of this particular situation.
  29.  
  30.                Before we go any further, I should warn you that if you only
  31.           use the root directory or if  you  are a perfect typist, JCD will
  32.           probably not help you. However, for  the  rest of us, it can mean
  33.           the difference  between finishing what you were doing and wasting
  34.           several minutes cursing a computer.
  35.  
  36.                JCD  was  actually  born from a situation similar to the one
  37.           mentioned  above,  although  not  quite  as  exaggerated.  In the
  38.           example  above,  JCD  would have changed directories  to  a  path
  39.           matching as much of the requested path as possible. Next, instead
  40.           of  the highly informative error message  returned  by  DOS,  JCD
  41.           gives you a subdirectory menu, allowing you to choose the one you
  42.           meant.
  43.  
  44.                JCD soon expanded to  cover  many of the CHDIR errors that I
  45.           make on a regular basis. In addition, several features were added
  46.           to make JCD a useful utility in its own right  instead  of just a
  47.           correction to the CD command.
  48.  
  49.  
  50.                                         Usage
  51.  
  52.                In general, JCD is used exactly the same as CD. For example,
  53.           if  you  wish to change from the  root  directory  to  your  UTIL
  54.           directory you type:
  55.  
  56.               C:\> jcd \util      or      C:\> jcd util
  57.  
  58.           and JCD takes you  to  the  proper  directory. The only situation
  59.           where JCD does not behave exactly like CD is when the  program is
  60.           used  with no command line parameters.  When  no  parameters  are
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           given, CD types the name of the current directory on  the screen.
  68.           JCD also types the  name  of the current directory; but, if there
  69.           are  any  subdirectories  to  choose  from, JCD brings up a  menu
  70.           allowing you to choose where to go next.
  71.  
  72.  
  73.                               What does JCD do for me?
  74.  
  75.                At this point you may be asking yourself the question above.
  76.           Then again, you may not. Oh  well,  I'm going to tell you anyway.
  77.           JCD does not have  a  bright,  beautiful, helpful user interface.
  78.           The  only  thing  that JCD does do is handle some of the problems
  79.           that occur with the use of one DOS command.
  80.  
  81.           JCD handles simple typing errors.
  82.  
  83.                     JCD  handles  a  wide  variety  of  typing  errors. For
  84.                instance, what if  you  type  "jcd  ,,". I know and you know
  85.                that you want to go up one level in the directory  tree. JCD
  86.                assumes that if you type a comma what you really meant was a
  87.                period. If you type a '/' instead of a '\', that's okay; JCD
  88.                knows what you mean  there  too. JCD also assumes that a ';'
  89.                is supposed to be a ':'.
  90.  
  91.           JCD can recursively search a disk for a directory.
  92.  
  93.                     How many times have you  typed "cd util" when you meant
  94.                "cd \util"?  JCD will handle this situation with a recursive
  95.                search of the directory structure,  if you allow it to. This
  96.                also  handles  the  situation where you know the name of the
  97.                subdirectory that you want to  go to, but you don't remember
  98.                what directory  it  is  under.  It  can  also match a set of
  99.                directories. For instance,  a recursive search for "inc\sys"
  100.                will send you  to  "\tc\inc\sys"  and  skip  "\bin\sys". For
  101.                those  of  us  who sometimes manage to  have  two  different
  102.                subdirectories  with  the  same  name,  JCD  allows  you  to
  103.                continue a recursive directory  search  if  it has found the
  104.                wrong subdirectory. At least for  now,  JCD  cannot  go more
  105.                than fifteen levels deep.
  106.  
  107.           JCD stops you from going to the root when you don't want to.
  108.  
  109.                     Say you are in  your  123 directory and wish to move to
  110.                the DATA subdirectory  under  123  (or  whatever).  How many
  111.                times have you typed:
  112.  
  113.                   C:\123> cd \data
  114.  
  115.                DOS tells you there is no such directory. Maybe you stare at
  116.                the screen in confusion for a few seconds.  Then  you notice
  117.                the '\' at the  front  of the directory name. JCD checks for
  118.                this error  and  asks  you  if  you  would like to move down
  119.                instead of going to the root.
  120.  
  121.  
  122.  
  123.  
  124.                                         - 2 -
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.           JCD simplifies moving towards the root.
  132.  
  133.                     DOS uses two special directory names (. and ..) for the
  134.                purpose of changing directories. JCD extends this concept to
  135.                allow easier access to directories closer to the root. Where
  136.                .. means 'parent', ... now means  grandparent  (..\..), ....
  137.                means  great-grandparent (..\..\..), and so on.This will  be
  138.                especially helpful for people with deep directory trees.
  139.  
  140.           JCD gracefully handles errors in path specification.
  141.  
  142.                     The  main reason for the JCD  program  is  the  problem
  143.                mentioned in the  introduction.  JCD  assumes  if  the first
  144.                portion of the path you typed is valid,  you  probably meant
  145.                to go at least that far.  In  fact, you will never again get
  146.                an "Invalid directory" error since  at  the  very  worst you
  147.                probably didn't misspell the root directory.
  148.  
  149.           JCD allows movement to another drive.
  150.  
  151.                     If you want to  move  to a new directory on a different
  152.                drive, DOS requires two different commands. First,  you must
  153.                change drives. Then, you can  change  to  the  directory you
  154.                want. With JCD, you can do both at the same time. If you are
  155.                on B  drive  and  wish  to go to the util directory on C you
  156.                type
  157.  
  158.                     B:> jcd c:\util
  159.  
  160.                and you are in c:\util in a single step. As mentioned above,
  161.                if you type "a;", JCD assumes that you meant "a:".
  162.  
  163.  
  164.                                       The Menu
  165.  
  166.                The next major feature of JCD is the subdirectory menu. This
  167.           menu shows the first sixty-four subdirectories  of  the directory
  168.           you are now  in.  You  may  choose one of these subdirectories by
  169.           using  the  UP,  DOWN, HOME, and END keys to move around and then
  170.           strike  ENTER.  Pressing  SPACE is the same as pressing DOWN. You
  171.           may also type a character, this will move the  highlight  bar  to
  172.           the  menu  entry  of the first subdirectory that begins with this
  173.           character. Pressing ENTER at this point will choose. Pressing ESC
  174.           wil